aus HisWiki

2.2 Kurzanleitung

Folgende Arbeitsschritte sind in der typischen Umgebung (SOS läuft unter Informix / Unix) notwendig:

  1. 1. Zunächst entpacken Sie das Archiv sos_modul0.6.tar.gz als User superx (nicht als root) an der Stelle $SUPERX_DIR. .Die Locale beim Entpacken sollte eine deutsche mit mindestens Zeichensatz LATIN-1 oder de_DE@euro sein. 

  2. 2. Einrichtung der SOS-bezogenen Umgebungsvariablen - Prüfen Sie ob in Ihrer $SUPERX_DIR/db/bin/SQL_ENV alle Einträge aus SQL_ENV.sos.sam vorhanden sind, ggfs. rüberkopieren ). Aktivieren Sie die Umgebung mit
    . $SUPERX_DIR/db/bin/SQL_ENV      

  3. 3. Benennen Sie die Datei $SUPERX_DIR/db/module/sos/rohdaten/SOS_ENV.sam nach SOS_ENV um und passen Sie die Umgebungsvariablen für den SOSPOS-Rechner an.  

  4. 4. Entscheiden Sie sich zunächst für ein "Push"- oder "Pull"-Verfahrne beim Entladen. Die häufigsten Modi sind erfahrungsgemäß: "Push" bei SOSPOS unter Inofrmix (Unix), "Pull" bei allen andere Systemen.
    Beim Entladen aus SOSPOS unter Informix im "Push"-Modus: Kopieren sie den Verzeichnisinhalt unter $SUPERX_DIR/db/module/sos/rohdaten zum SOS-Rechner, bzw. mounten Sie das Verzeichnis auf dem SuperX-Rechner 2 . Laden und testen Sie dann die Umgebung in SOS_ENV.
    Beim Entladen aus SOSPOS unter Postgres im "Pull"-Modus: Laden Sie die Umgebung in SOS_ENV und richten Sie mit dem propadmin.x die Datenbankverbindung zum SOSPOS-Rechner ein. 

  5. 5. Führen Sie (bei SOS-Informix und SOS-Postgres) einmal in der SOS-Datenbank das Script
    superx_sos_install.x aus.  

  6. 6. Ausführen des Entladescripts $SUPERX_DIR/db/module/sos/rohdaten/sos_unload.x für die Basisdaten (ältere SOS-Versionen unter Informix: sos5_unl_ids.x )  

  7. 7. Ggf. Kopieren des Rohdaten-Verzeichnis der entladenen SOS-Daten nach $SUPERX_DIR/db/module/sos/rohdaten
    Ein Scripte dafür heißt sos_copy.x  

  8. 8. Laden Sie für die folgenden Schritte die Umgebung für SuperX
    . $SUPERX_DIR/db/bin/SQL_ENV
    Erzeugen des SOS-Moduls in der SuperX-Datenbank:
    $SUPERX_DIR/db/module/sos/sos_modul_erzeugen.x
     Falls ein Fehler auftritt, versuchen Sie die Ursache zu beheben, starten Sie dann
    $SUPERX_DIR/db/module/sos/sos_modul_entfernen.x
    (etwaige Fehler können normalerweise ignoriert werden)
    und anschließend erneut
    $SUPERX_DIR/db/module/sos/sos_modul_erzeugen.x
      

  9. 9. Nur wenn Sie Tomcat auf einem separaten Rechner betreiben: Fügen Sie den Inhalt der Datei
    $SUPERX_DIR/webserver/tomcat/webapps/superx/WEB-INF/sos_dbforms_config_<<pg für Postgres oder ids für Informix)>>.xml     vom Kommentar "<!--Hier beginnt Moduldefinition-->" bis zum Kommentar "<!--Hier endet Moduldefinition-->" in Ihre dbforms-config.xml ein.
    Danach starten Sie Tomcat neu. 

  10. 10. Übernahme der entladenen SOS-Daten nach SuperX:
    $SUPERX_DIR/db/module/sos/sos_update.x
    Wenn Sie die Lehreinheits - oder Fachbereichszuordnung in SOS pflegen, sollten Sie beim ersten Update schreiben:
    $SUPERX_DIR/db/module/sos/sos_update.x       --mit-lehreinheiten  

  11. 11. Ggf. Anpassen der Schlüsseltabellen , insbes. der lehr_stg_ab  

  12. 12. Prüfen des Update, Testen der Abfragen 

  13. 13. Schritt 10 kann jede Nacht wiederholt werden. Dazu muss der Entladerhythmus geplant werden, und die Cronjobs werden eingerichtet.